<html>
<head><meta charset="utf-8"><title>Reorganizing the guide · t-compiler/wg-rustc-dev-guide · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/index.html">t-compiler/wg-rustc-dev-guide</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html">Reorganizing the guide</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="201775078"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775078" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775078">(Jun 23 2020 at 20:01)</a>:</h4>
<p>I'm creating this thread to collect some of the discussion about reorganizing the guide...</p>



<a name="201775427"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775427" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775427">(Jun 23 2020 at 20:04)</a>:</h4>
<p>Basically, there are two issues we want to resolve, both of which require some discussion:</p>
<ol>
<li><a href="https://rustc-dev-guide.rust-lang.org/part-1-intro.html">Part 1</a> of the guide feels like a large collection of random things. It would be nice to break it into smaller, more logical units</li>
<li>Niko and Santiago were suggesting that we should move more procedure-related stuff to the forge and just link extensively to it from the guide. That way the guide would be mostly about how the compiler works.</li>
</ol>



<a name="201775749"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775749" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775749">(Jun 23 2020 at 20:06)</a>:</h4>
<p>Related: <a href="https://github.com/rust-lang/rustc-dev-guide/pull/753">https://github.com/rust-lang/rustc-dev-guide/pull/753</a> does some breaking up of Part 1</p>



<a name="201775763"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775763" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775763">(Jun 23 2020 at 20:07)</a>:</h4>
<p>Some previous discussions:</p>



<a name="201775770"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775770" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775770">(Jun 23 2020 at 20:07)</a>:</h4>
<ul>
<li><a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/Emitting.20Errors.20and.20other.20Diagnostics">https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/Emitting.20Errors.20and.20other.20Diagnostics</a></li>
</ul>



<a name="201775816"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775816" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775816">(Jun 23 2020 at 20:07)</a>:</h4>
<ul>
<li><strong>READ THIS ONE</strong> <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/forge.20vs.20rustc-dev-guide">https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/forge.20vs.20rustc-dev-guide</a></li>
</ul>



<a name="201775935"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201775935" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201775935">(Jun 23 2020 at 20:08)</a>:</h4>
<ul>
<li><a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/Merging.20.22suggested.20workflows.22.20into.20.60CONTRIBUTING.2Emd.60">https://rust-lang.zulipchat.com/#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/Merging.20.22suggested.20workflows.22.20into.20.60CONTRIBUTING.2Emd.60</a></li>
</ul>



<a name="201776316"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201776316" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201776316">(Jun 23 2020 at 20:12)</a>:</h4>
<ul>
<li><strong>READ THIS ONE</strong> <a href="#narrow/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide">https://rust-lang.zulipchat.com/#narrow/stream/131828-t-compiler/topic/forge.20vs.20compiler-team.20vs.20rustc-dev-guide</a> </li>
<li><a href="#narrow/stream/131828-t-compiler/topic/idea.3A.20starters.2Erust-lang.2Eorg">https://rust-lang.zulipchat.com/#narrow/stream/131828-t-compiler/topic/idea.3A.20starters.2Erust-lang.2Eorg</a></li>
<li><a href="#narrow/stream/131828-t-compiler/topic/idea.3A.20contribute.2Erlo.3F">https://rust-lang.zulipchat.com/#narrow/stream/131828-t-compiler/topic/idea.3A.20contribute.2Erlo.3F</a></li>
<li><a href="#narrow/stream/131828-t-compiler/topic/So.20you.20want.20to.20add.20a.20compiler.20option">https://rust-lang.zulipchat.com/#narrow/stream/131828-t-compiler/topic/So.20you.20want.20to.20add.20a.20compiler.20option</a></li>
</ul>



<a name="201776472"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201776472" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201776472">(Jun 23 2020 at 20:14)</a>:</h4>
<p>And finally, here was a proposed organization from some prior discussions: <a href="https://hackmd.io/5BnDamiMSFOO8A_S5xggYQ">https://hackmd.io/5BnDamiMSFOO8A_S5xggYQ</a></p>



<a name="201783048"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/201783048" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#201783048">(Jun 23 2020 at 21:05)</a>:</h4>
<p><span class="user-mention" data-user-id="198054">@mark-i-m</span> this is great <span aria-label="clap" class="emoji emoji-1f44f" role="img" title="clap">:clap:</span></p>



<a name="203548315"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203548315" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203548315">(Jul 10 2020 at 19:23)</a>:</h4>
<p><span class="user-mention" data-user-id="116266">@Santiago Pastorino</span> Hey, were you still planning to put up a PR about reorganizing?</p>



<a name="203549256"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549256" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549256">(Jul 10 2020 at 19:33)</a>:</h4>
<p>ouch, man, sorry about this</p>



<a name="203549274"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549274" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549274">(Jul 10 2020 at 19:33)</a>:</h4>
<p>so it's in my todo list, but didn't have time to get into it</p>



<a name="203549324"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549324" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549324">(Jul 10 2020 at 19:34)</a>:</h4>
<p>if you want to go ahead I don't want to stop anyone</p>



<a name="203549336"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549336" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549336">(Jul 10 2020 at 19:34)</a>:</h4>
<p>I can just check later and make my suggestions</p>



<a name="203549349"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549349" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549349">(Jul 10 2020 at 19:34)</a>:</h4>
<p>but if you still want me to give it a shoot I will try to do so as soon as I can</p>



<a name="203549360"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549360" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549360">(Jul 10 2020 at 19:34)</a>:</h4>
<p>but I've been waaay busier</p>



<a name="203549759"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549759" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549759">(Jul 10 2020 at 19:38)</a>:</h4>
<p>No worries. I just wanted to see if it was still on your radar <span aria-label="slight smile" class="emoji emoji-1f642" role="img" title="slight smile">:slight_smile:</span><br>
Unfortunately, bandwidth is a bit limited for me for the coming 2-3 weeks...</p>



<a name="203549820"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203549820" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mark-i-m <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203549820">(Jul 10 2020 at 19:39)</a>:</h4>
<p>Also, I think you have a better idea of what you and Niko were thinking of wrt forge vs guide</p>



<a name="203550146"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing%20the%20guide/near/203550146" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Reorganizing.20the.20guide.html#203550146">(Jul 10 2020 at 19:42)</a>:</h4>
<p><span aria-label="+1" class="emoji emoji-1f44d" role="img" title="+1">:+1:</span>, let's see what I can do</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>